home *** CD-ROM | disk | FTP | other *** search
/ Alles Voor Internet / Tout Pour Internet / alles voor internet.iso / MacInternet™ / Ph 1.2 / mod-history < prev    next >
Text File  |  1995-02-02  |  22KB  |  431 lines
  1. Mac Ph Client Modification History
  2. ==================================
  3.  
  4.  
  5. Version 1.2. 1/6/95.
  6. --------------------
  7.  
  8. Version 1.2 can be used as a helper program with the new 2.0 beta
  9. versions of TurboGopher from the University of Minnesota Gopher team.
  10. You no longer need to use the special version 1.1.1G which Minnesota
  11. distributed along with TurboGopher. Unlike the Minnesota version
  12. 1.1.1G, our new version 1.2 does *not* change your default site when
  13. you use the program with TurboGopher.
  14.  
  15. Ph 1.2 supports the standard "geturl" Apple event suite. You can send
  16. Ph an Apple event to tell it to open a query window for a given Ph
  17. server and optionally do a query and display the results in the window.
  18.  
  19. The URL standard does not include ph URLs. Farhad Anklesaria (the
  20. author of TurboGopher), Steve Dorner (the author of Eudora), and I
  21. invented the following syntax for this kind of URL:
  22.  
  23.    ph://server/query       server and query specified
  24.    ph://server             no initial query
  25.    ph://server/            no initial query
  26.    ph:///query             use default server
  27.  
  28. For example, the following Apple script tells Ph to open a query window
  29. for the Northwestern University Ph server, do a query for "norstad",
  30. and display the result in a window:
  31.  
  32.    tell application "Ph"
  33.          geturl "ph://ns.nwu.edu/norstad"
  34.    end tell
  35.  
  36. The "NewsWatcher" Usenet newsreader uses this new "geturl" event to use
  37. Ph as a helper program for opening ph URLs. (This new feature is
  38. introduced in version 2.0b23 of NewsWatcher.)
  39.  
  40. Ph now includes an Apple event terminology resource, so you can use it
  41. in Apple scripts.
  42.  
  43. Version 1.1.1. 11/5/92.
  44.  
  45. - (Pete Resnick). The site list popup menu sometimes extends beyond the
  46. left edge of query windows. Fixed.
  47. - (Pete Resnick). The Cancel button does not properly cancel in the
  48. change default server window. Fixed.
  49.  
  50. Version 1.1. 6/30/92.
  51.  
  52. - Ph version 1.0.2 does not work at all with the new MacTCP 1.1.1. 
  53. At startup, the following bogus error message is issued:"MacTCP is 
  54. improperly configured. No domain name servers are defined." 
  55. Ph version 1.1 fixes this problem. (At the time this is being written,
  56. June 30, 1992, Apple has said that MacTCP 1.1.1 should be released
  57. to the public sometime this fall. We recommend that all Ph users
  58. upgrade to Ph 1.1 now so they won't have any problems when the new
  59. MacTCP is released.)
  60. - Ph no longer strips leading blanks from field lines before displaying
  61. them in editing windows.
  62. - The remaining changes are intended primarily for the convenience of 
  63. heros.
  64. - Only heros can edit fields which do not have the "change" attribute.
  65. Editing these fields, however, can be dangerous even for heros. To 
  66. remind heros that they should think twice before editing such a field, 
  67. they are marked with the special "section mark" character in editing
  68. windows in hero mode.
  69. - The "Open Ph Record" command now lets you open the record by alias,
  70. name, or id, rather than just by alias or name. Steve Dorner requested 
  71. this change, and he wrote the code.
  72. - We now permit the use of the Edit menu commands Copy, Paste, and Select
  73. All with password fields in the New Ph Record, Login, and Change Password
  74. dialogs. For example, if someone sends you a request to change their
  75. password to "abc123", you can now copy the new password from the mail
  76. message and paste it into the Ph Change Password dialog.
  77.  
  78.  
  79. Version 1.0.2. 10/21/91.
  80. ------------------------
  81.  
  82. - (Pete Resnick, Steve Dorner). With System 7 and MacTCP 1.1, version
  83. 1.0.1 would sometimes get "unexpected error -23048" on attempts to
  84. contact a server. This problem should be fixed in 1.0.2. We're not
  85. sure what causes this error, although we suspect that the MacTCP 1.1
  86. domain name resolver may be the culprit. In any case, 1.0.2 contains
  87. a workaround which appears to fix the problem, at least in our tests.
  88. The fix involves closing and reopening the MacTCP resolver and trying
  89. again if the -23048 error occurs on any attempt to resolve a domain 
  90. name.
  91. - Version 1.0.2 always puts exactly one blank line at the end of all
  92. help windows. This makes the help text a bit more readable.
  93.  
  94.  
  95. Version 1.0.1. 10/16/91.
  96. ------------------------
  97.  
  98. - (Hal Bloom). Under System 7, when 1.0 is run on a new Mac (no "Ph
  99. Prefs" file exists in the Preferences folder), it fails to properly
  100. create the prefs file. This is a major error which is fixed in 1.0.1.
  101. The error was introduced by some code I added in version 1.0b7, but
  102. nobody caught it.
  103. - (Chris Chen). If MacTCP is not installed, Ph reports "unexpected
  104. error -43" on launch. This uninformative message has been changed
  105. to "MacTCP is not installed, or it is improperly configured."
  106. - (Pete Resnick). Pete wrote: "OK, I admit this was a silly thing 
  107. to do in the first place: I did the following query: 
  108. 'office_phone=*1265 return name'. I was in a mood to play.
  109. Well, as you can imagine this took a long time. While I was waiting, I
  110. switched into Finder to play with some stuff. Some time later, the
  111. application menu was flashing the ph icon. I switched back into ph 
  112. at which point it gave me the alert: Unknown error -20008. That's
  113. connectionDoesntExist. In the query result area it said "CPU time limit
  114. exceeded for this session." Hmmmm... someone is misbehaving."
  115. This error is fixed - The bogus "unknown error" alert no longer
  116. appears.
  117.  
  118. Version 1.0. 10/15/91.
  119.  
  120. - (Audrey Rosen). If the user renamed the MacTCP control panel, Ph
  121. would get "unexpected error -43" on launch. This error has been
  122. fixed.
  123. - If a Help topic contains the substring "..", only the portion
  124. of the string following the first such ".." substring is displayed
  125. in the Help menu. Server administrators can use the characters before
  126. the ".." to determine the order in which the topics appear in the 
  127. menu (they are sorted alphabetically). This makes the Help menu look
  128. lots nicer to the user.
  129. - (Hal Bloom). If no Ph windows are open, Ph is in the backgound
  130. under System 7, Finder is in the foreground, and the user double-
  131. clicks on the Ph icon to bring it to the front, the cursor is a
  132. wristwatch instead of an arrow. This error is fixed.
  133.  
  134. Version 1.0b8. 10/8/91.
  135.  
  136. - Correct an error which sometimes failed to properly report read-only
  137. database status on logins.
  138. - If you popup a site popup menu and select the same site in the popup
  139. menu which was previously selected, version 1.0b7 did not update the
  140. site domain name field. This has been fixed.
  141.  
  142. Version 1.0b7. 10/1/91.
  143.  
  144. - Fixed a minor error in the query window scroll bar.
  145. - IM VI 3-15 says not to call ModalDialog when the frontmost window
  146. is a movable modal dialog. I found out why when implementing Balloon
  147. Help - it screws up the menu bar, and the Help menu in particular.
  148. So I don't do this anymore. In cases where I need to present an
  149. error message when a movable modal dialog is frontmost, I dismiss
  150. the movable modal dialog, then I put up the error message alert,
  151. and then I bring back the movable modal dialog.
  152. - Ph has been tested with the new MacTCP 1.1. It works fine. 
  153. - Implement Tech Note #304, "Pending Update Perils." This tech note
  154. discusses the proper handling of update events when a modal dialog
  155. is active. This is especially important now that we support balloon
  156. help. It also makes Ph behave properly when a modal dialog is active
  157. and a screen saver kicks in - when you deactivate the screen saver,
  158. Ph now properly redraws all of its windows.
  159. - Fixed an error which sometimes caused labels in some of the movable
  160. modal dialogs to be drawn in the wrong font and size.
  161. - Under System 7, Ph supports balloon help for all menus, dialogs, and
  162. windows. The Ph application icon also has a custom Finder help balloon.
  163. There's 96 help messages total (whew!).
  164. - Just for yucks, check out the help balloon for the Ph icon in the Ph 
  165. about box (bring up the about box, turn on balloon help, and park the
  166. cursor over the copy of the Ph icon in the upper right hand corner of
  167. the about box).
  168. - The Help menu has been restructured. Instead of having a list of known
  169. Ph servers at the end of the menu, there is now a single command "Change
  170. Ph Help Server" at the beginning of the menu. This new command brings
  171. up a server site selection dialog which is very similar to the one
  172. used by the "Change Default Server" command.
  173. - Under System 7, there is no separate Help menu. Instead, the help 
  174. commands are appended to the end of the standard System 7 help 
  175. menu at the right side of the menu bar. Apple recommends that all
  176. help commands be located in this menu (see IM VI pp. 2-34 and 11-61).
  177. - Under System 6, the positions of the Windows and Help menus have
  178. been interchanged so that the Help menu comes last. This makes the
  179. menu bars under System 6 and System 7 a bit more consistent.
  180. - Under System 7, the "Ph Prefs" preferences file in the Preferences 
  181. folder may now be an alias, with the actual prefs file stored elsewhere.
  182. I have no idea why someone would want to do this, but if they try it,
  183. it should work.
  184. - Ph now checks for System 6.0.5 or later.
  185. - (Ed Dewan) Ed reported: "I have discovered that if I click on several 
  186. applications in the same folder at once (with the shift key held down), 
  187. including Ph, then Ph opens up and all the other applications are dropped. 
  188. Is this caused by Ph, or is it a system problem? It only happens when Ph 
  189. is present in the mix." Ed said he was using System 6.0.5. I was unable
  190. to reproduce this problem under 6.0.5 with Ph 1.0b7, so for now I'm
  191. chalking this one up to cosmic rays.
  192. - Ph now supports the four required Apple events under System 7. 
  193. - The Open Application, Open Documents, and Print Documents events have 
  194. no meaning in the context of Ph. They are accepted but ignored (they do 
  195. nothing). 
  196. - The Quit Application event causes Ph to quit. 
  197. - Local clients (clients on the same computer as Ph) may specify that Ph 
  198. is or is not permitted to interact with the user when they send Ph a
  199. Quit Application event. If a local client specifies the kAECanInteract 
  200. or kAEAlwaysInteract option, Ph interacts with the user just as if the 
  201. user had selected the Quit command from the File menu: If any open edit 
  202. windows contain unsaved changes, the usual "Do you want to save changes" 
  203. alert is presented. If a local client specifies the kAENeverInteract
  204. option, Ph quits without presenting any save changes alerts. In this
  205. case, any unsaved changes in edit windows are lost.
  206. - If a remote client (a client on a different computer than Ph) sends
  207. Ph a Quit Application event, Ph never interacts with the user. That is,
  208. in this case, Ph always uses the kAENeverInteract option, no matter
  209. what interaction preference was requested by the remote client.
  210. - See Inside Mac VI pages 6-51 through 6-54 for more details on these
  211. user interaction complexities.
  212. - As distributed, Ph only accepts Apple events from local clients.
  213. If a user wishes to have Ph also accept network events, he must use
  214. the "Sharing" command in the Finder's File menu to enable remote
  215. program linking to his copy of Ph.
  216. - Ph can now run in the background. If Ph is in the background and
  217. needs to present an alert, the Notification Manager is used to inform
  218. the user that Ph requires attention. A diamond appears next to the
  219. name of the Ph applicaton in the Application menu (System 7) or the
  220. Apple menu (System 6), and the small Ph icon flashes in the menu bar
  221. by periodically alternating with the Application menu icon (System 7)
  222. or the Apple menu icon (System 6). When the user brings Ph to the
  223. foreground, the notification is removed and the alert is presented.
  224. - Added full color icon families for System 7. If you have been
  225. running any of the previous versions of Ph on your Mac, you'll have
  226. to rebuild your desktop file before you will see the color icons (sorry
  227. about that). 
  228. - The login dialog now has a popup menu the user can use to select
  229. the login server.
  230. - (Butch Kemper and others). Added a Logout command to the File menu.
  231. This command closes all open edit windows and clears the current 
  232. login status. Note that open edit windows are always "logged in" in
  233. the sense that if such a window is open, the user can make changes
  234. and save them. So to effectively "logout," we really do have to close
  235. all open edit windows.
  236. - The menu bar is properly unhilited when the movable modal dialogs
  237. are presented by the Change Password and Change Default Server commands.
  238. - Multiple-line server error messages are now handled properly. For
  239. example, "Your email field must not contain addresses ending in nwu.edu;
  240. Use a specific login and machine instead." In 1.0b6, only the first
  241. line of such an error message was displayed (in the example, only the
  242. text up through the semi-colon appeared in the alert).
  243. - (Steve Dorner). When entering a password, make the Delete key erase 
  244. just the last character, not the whole password.
  245. - (Pete Resnick). In the query and edit windows, use shift-tab for 
  246. backwards tabbing instead of option-tab.
  247. - Ph now reacts properly when the database is shut off. The message
  248. issued by the server on connection attempts is displayed to the user.
  249. E.g., "Database shut off (for maintenance)." For queries, the message
  250. is displayed in the query window. For all other operations (login, get
  251. help, etc.), the message is displayed in an alert. Note that Steve 
  252. Dorner's "Rebuild" doc has a mistake - it says to put a line beginning 
  253. with "stop" in file prod.sta. Actually, the line must begin with "off". 
  254. Also, the server error code (555) is undocumented.
  255. - On queries, CPU time limit exceeded server errors are now handled
  256. properly. The server error message is displayed in the query result
  257. field. On our NU server, the query "office_phone=*4080" is a good test
  258. of this error.
  259. - (Steve Dorner). Fixed an error involving heros changing passwords
  260. for other open records. After changing such an open record, any attempt 
  261. to make further changes to the record resulted in the error message "the 
  262. alias or password is incorrect." 
  263. - (Ed DeWan). In the query window, as you move the cursor over the
  264. window, it changes from an arrow to an ibeam when the cursor is
  265. positioned over any of the three text fields. In the query text
  266. field, the left coordinate of the ibeam rectangle was off by 6 pixels.
  267. This problem has been fixed.
  268. - The new MacTCP 1.1b1 appears to have fixed the problems I was 
  269. having with the domain name resolver. The problem was that sometimes
  270. (often) my resolver result proc was being called with the result code
  271. still set to cacheFault, and I was reporting this to the user as a
  272. "domain name server timeout." I had abandoned the MacTCP resolver and
  273. wrote my own resolver to get around this problem. Now I do the 
  274. following: I use the MacTCP resolver. If my result proc is called with 
  275. the error code still set to cacheFault, I then try my resolver. This 
  276. should make Ph work with both versions of MacTCP, and use the MacTCP 
  277. resolver when possible.
  278.  
  279. Version 1.0b6. 5/1/91.
  280.  
  281. (Gary Jacobs). In 1.0b5, if you tried to create a record with a
  282. duplicate alias, Ph reported an "unexpected error 509." This mistake
  283. has been corrected.
  284.  
  285. In 1.0b6, the Quit command is active during movable modal dialogs.
  286.  
  287. Version 1.0b5. 4/28/91.
  288.  
  289. (Bruce Foster). When Bruce first ran 1.0b4, it asked him to select a
  290. default server, which he did (after playing with the menu for a while,
  291. he set it back to NU). When the initial query window came up, the site
  292. popup menu was all screwed up (it had width 0). I'm not quite sure why
  293. this happened, but I managed to reproduce it, and I fixed it. Sometimes
  294. the Mac toolbox is just too mysterious for words.
  295.  
  296. Version 1.0b4. 4/26/91.
  297.  
  298. (Steve Dorner). You will all be happy to hear that it is no longer
  299. necessary to use ResEdit to change the STR 128 resource to the domain
  300. name of your site's server.
  301.  
  302. The STR 128 resource is now the "default default server" rather than
  303. the "default server". The "default server" is chosen by the user the
  304. first time he or she uses the program, and it is subsequently saved
  305. on the prefs file. The "default default server" is only used to fetch
  306. the initial site list for the popup menu which is presented in the
  307. initial dialog asking the user to select a default server. Does this 
  308. make sense to you?
  309.  
  310. The first time you run 1.0b4 you will see this dialog in action. 1.0b4
  311. will blow away your old preferences and create new ones.
  312.  
  313. The new command "Change Default Server" in the "File" menu can be used
  314. to change your default server.
  315.  
  316. You can still use ResEdit to change the default default server in the
  317. STR 128 resource to your local server instead of ns.nwu.edu if you
  318. wish, and this is a good idea, but it is no longer required.
  319.  
  320. No, I have no plans for a "default default default server". :-)
  321.  
  322. (Gary Jacobs, jwn2). In 1.0b3, if no windows were open, typing 
  323. anything caused a crash. The errror is fixed.
  324.  
  325. (Gary Jacobs, jwn2). 1.0b3 had horrible problems with really long
  326. query replies from a server, e.g., the >80K reply with 228 matches
  327. you get if you query ns.uiuc.edu for "restaurant". The dumb mistakes
  328. I made are way too numerous too mention. They're all fixed (I hope).
  329.  
  330. By the way, I use the built-in Mac TextEdit routines to display query
  331. replies, and those routines cannot handle more than 32K of text. Among
  332. the other problems I fixed involving big query replies, I now truncate 
  333. any replies which exceed this limit and put the special message
  334. "----- The query reply was too long. It was truncated" at the end of
  335. the truncated reply.
  336.  
  337. (Gary Jacobs, jwn2). My syntax error checking of query replies was
  338. a bit too strong. 1.0b4 relaxes the checks to permit legal but unusual 
  339. replies.
  340.  
  341. (Hal Bloom, Ron Rusnack). When an error occurs on an attempt to
  342. change a field value, I now display the server error message as received
  343. from the server instead of displaying my own error message based on the
  344. server error number.
  345.  
  346. If multiple errors occur on an attempt to save an edited record with
  347. several changed fields, I now display individual error alerts for
  348. each field which was in error. Each of the individual error alerts
  349. displays the error message as received from the server.
  350.  
  351. (Gary Jacobs, jwn2). The Mac Ph client uses the alias field to uniquely
  352. identify a record which is being edited. It cannot be used to edit
  353. records which do not have an alias. 1.0b3 didn't deal gracefully with
  354. attempts to do this.
  355.  
  356. If you tried to log in to a record which had no alias, 1.0b3 reported 
  357. "unexpected server error 508". 1.0b4 instead reports "You cannot login 
  358. to a record which has no alias."
  359.  
  360. 1.0b4 does not permit a logged in user to open a record for editing 
  361. if it does not have an alias. The error message is "You cannot open a 
  362. record which has no alias". 1.0b3 let you open such a record, but any
  363. attempt to save changes failed with confusing error messages.
  364.  
  365. 1.0b4 does not permit you to attempt to save an edited record if the
  366. alias field has been changed to be empty. The error message is "You
  367. cannot save a record with an empty alias field."
  368.  
  369. Version 1.0b3. 4/21/91.
  370.  
  371. - Option-tab now works in the query window - it backs up to the previous
  372. field. (Pete Resnick).
  373. - In edit windows, when the "Show field info" option is toggled, I now
  374. position the display in the window so that the current field is
  375. always visible. (Pete Resnick).
  376. - In 1.0b2 the Windows menu was not always properly activated, e.g., 
  377. after a query. This error is fixed in 1.0b3.
  378. - Server error numbers are no longer presented to the user when errors
  379. occur in queries or when fetching help text. Only the server error
  380. messages are presented. E.g., "No matches to your query." is now 
  381. displayed in the query window instead of "Server error 501:No matches
  382. to your query."
  383. - The Help menu no longer lists any help topics whose titles consist
  384. only of decimal digits. This eliminates all the native server error
  385. number help topics, which are completely irrelevant to the
  386. Mac Ph client, which never reports server error numbers to the user
  387. anyway. This makes the Help menu much shorter. In 1.0b2 the menu was
  388. ridiculously long and hence cumbersome when used with any site except
  389. for NU. You probably won't notice this change immediately, since the
  390. old Help menu topic list is kept on the Ph prefs file and is only 
  391. updated every 24 hours. To force an update so you can see the new
  392. menu, select your site from the site list at the bottom of the Help
  393. menu. (Bruce Foster).
  394.  
  395. Version 1.0b2. 4/17/91.
  396.  
  397. - 1.0b1 crashed horribly if you tried to open a new help window when 
  398. there were no open windows.
  399. - Fixed an error redrawing the server popup menu box in the Query 
  400. window when the site list changed.
  401. - Fixed an error saving changed fields when both the alias and some 
  402. other field were changed.
  403. - The page up, page down, home and end keys now work with all three
  404. kinds of windows (query, edit, and help).
  405. - The arrow keys now work in the query and help windows.
  406. - Fixed the error message that's displayed if you attempt to login 
  407. with a valid alias but a bad password.
  408. - In query replies, if any line extends beyond 80 characters, the 
  409. field containing the long line is reformatted as follows:
  410.          field_name:
  411. field text field text field text field text field text field text 
  412. field text field text field text field text field text field text 
  413. field text field text field text field text field text field text 
  414. field text field text field text field text field text field text 
  415. field text field text field text field text field text field text 
  416. For an example, query the UIUC server for "weather". This used
  417. to look awful with 1.0b1. It looks much better with 1.0b2.
  418. - Fixed a stupid mistake: Non-heros who log in and then close their
  419. login window are now permitted to reopen their record with the "Open
  420. Ph Record" command.
  421. - The prefs file now has a creator, type, and icon. To see the new
  422. icon you will have to trash the old prefs file, rebuild your desktop, 
  423. and then run the new version of Ph to create the new prefs file.
  424. (Sorry about that - don't bother if you don't care).
  425. - A much better error message is now displayed when a hero attempts
  426. to create a new record and specifies an illegal value for one of 
  427. the fields (e.g., alias too long or too short or contains an
  428. illegal character).
  429.  
  430. Version 1.0b1. 4/11/91. First beta release.
  431.